home *** CD-ROM | disk | FTP | other *** search
/ Amiga News 95 / Amiga News 95.iso / dpat / dpat12 / mdwi / mdwi.doc < prev    next >
Encoding:
Text File  |  1978-01-19  |  3.5 KB  |  133 lines
  1.  
  2.                     MDWI (MakeDir With Icon) DOCUMENTATION
  3.  
  4. PREAMBULE 
  5.  
  6.     MDWI est freeware et ne doit, dans aucun cas, faire l'objet d'un quelconque
  7.   négoce.
  8.     Son utilisation est au risque et péril de son utilisateur et l'auteur ne
  9.   pourra être rendu responsable d'une quelconque déterioration de quoique ce
  10.   soit.
  11.     Si vous avez des idées à me soumettre, voici où vous pouvez me joindre :
  12.  
  13.  
  14.                     PERRINE Bertrand
  15.                     3, rue des Ecoles
  16.                     88240 BAINS-LES-BAINS
  17.  
  18.  
  19. LE POURQUOI DU COMMENT
  20.  
  21.     Avant le 2.0, je n'utilisais que trés peu le worben (WorkBench). Maintenant
  22.   je l'utilise un peu plus que le cli. Malheureusement, à chaque création d'un
  23.   répertoire avec la commande MakeDir, il fallait copier une icone adéquate 
  24.   juste aprés.
  25.     C'est pourquoi MDWI fut écrit ET QU'IL NE FONCTIONNE QUE SOUS 2.0.
  26.                                   -----------------------------------
  27.  
  28.  
  29. LE FONCTIONNEMENT
  30.  
  31.     Le plus dur est de taper la commande qui répond au standard Amiga.
  32.  
  33.   si vous tapez :
  34.  
  35. 1.DUR:>mdwi ?
  36.  
  37.   vous obtenez :
  38.  
  39. 1.DUR:>mdwi ?
  40. NAME/M,ICON/S: 
  41.  
  42.   ce qui indique que vous pouvez entrer autant de nom de répertoire que vous
  43.   voulez et indiquez le mot clef ICON si vous voulez une icone avec chaque
  44.   répertoire :
  45.  
  46. 1.DUR:>mdwi ?
  47. NAME/M,ICON/S: rep1 rep2 ICON
  48.  
  49.   ou encore :
  50.  
  51. 1.DUR:>mdwi rep
  52. 1.DUR:>mdwi rep icon
  53. 1.DUR:>mdwi rep1 rep2 rep3 rep4
  54. 1.DUR:>mdwi rep1 icon rep2 rep3 rep4
  55. 1.DUR:>mdwi rep1 ICON rep2 rep3 rep4
  56.  
  57.   Les messages d'erreur sont les mêmes que pour la commande MakeDir.
  58.  
  59.     La commande ne peut pas créer en même temps des répertoires avec icones et
  60.   sans icones (et pis quoi encore ?). Le mot clef peut être taper en minuscule.
  61.   Et si, d'aventure, vous voulez créer un répertoire nommé icon, utilisez la
  62.   vieille commande.
  63.  
  64.  
  65.  
  66. A PROPOS DU PROGRAMME
  67.  
  68.   Il est trés simple et utilise le merveilleux OS 2.0.
  69.  
  70.   En voici le squelette :
  71.  
  72. fonction de traitement des arguments cli (ReadArgs)
  73.  
  74.   si structure RDArgs ok
  75.  
  76.     si arguments fournis
  77.       argument en cour = premier argument
  78.  
  79.       tant que l'argument en cours ne pointe pas zéro
  80.         fonction sur l'argument pour vérifier si le nom est déjà employé (Lock )
  81.  
  82.         si le nom est employé
  83.           envoi d'un message d'erreur
  84.         sinon
  85.           fonction de création du repertoire (CreateDir)
  86.  
  87.           si la création à échouée
  88.             envoie d'un message d'erreur
  89.           sinon
  90.  
  91.             si mot clef ICON
  92.               appel de la routine FaireIcone
  93.  
  94.         fonction de libération du nom (UnLock)
  95.         argument en cour = argument suivant
  96.  
  97.  
  98.       sinon (pas d'arguments fourni)
  99.         envoi d'un message
  100.  
  101.     fonction de libération de la structure RDArgs (FreeArgs)
  102.  
  103.   sinon (pas de structurs RDArgs)
  104.     envoi d'un message d'erreur
  105.  
  106. FIN du programme
  107.  
  108. ROUTINE FaireIcone
  109.  
  110.   fonction d'ouverture de la bibliothèque icon.library (OpenLibrary)
  111.  
  112.   si la bibliothèque à été ouverte
  113.     fonction d'obtention de l'icone par défaut de type "DRAWER" (GetDefDiskObject)
  114.  
  115.     si l'icone est obtenue
  116.       fonction d'écriture d'une icone (PutDiskObject)
  117.  
  118.         si l'écriture c'est mal passé
  119.           appel d'une routine qui envoi un message d'erreur
  120.  
  121.       fonction de libération des structures de l'icone (FreeDiskObject)
  122.  
  123.     sinon
  124.       appel d'une routine qui envoi un message d'erreur
  125.  
  126.     fonction fermant la bibliothèque (CloseLibrary)
  127.  
  128.   sinon
  129.     envoi d'un message d'erreur
  130.  
  131. FIN de la routine FaireIcone
  132.  
  133.   La routine d'envoie de message n'est pas décrite car elle est trés simple.